home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / sticpsrc.lzh / DOC / NODE.ARC / NODE.TXT < prev   
Text File  |  1990-06-23  |  16KB  |  549 lines
  1. Configuring a remote-controlled node using NET.PE1CHL
  2.  
  3. Because some nodes are now converting from NET/ROM running on a 
  4. TNC2 clone to a PC or Atari ST, using an SCC (8530) board and 
  5. running TCP/IP NET, some guidelines are collected in this 
  6. document to help configuration of such a node.
  7.  
  8.  
  9. Auto-start of program
  10.  
  11. The system must be configured in such a way, that it will 
  12. automatically start the NET program when powered-up or RESET, and 
  13. will re-start whenever the NET program exits.  This can be easily 
  14. accomplished:
  15.  
  16. -    Atari ST systems:
  17.  
  18.      Create a folder (directory) on the startup disk, named AUTO.
  19.      Copy the NET program into this folder, and name it "NET.PRG" 
  20.      (not NET.TOS, as it is normally distributed).
  21.      After that, copy a program into the AUTO folder that will 
  22.      reboot the machine.  Such programs are available in the 
  23.      public domain, and can be obtained from PE1CHL too.
  24.  
  25. -    MS-DOS systems:
  26.  
  27.      At the end of the AUTOEXEC.BAT file on the startup disk, put 
  28.      the "NET" command to start "NET.EXE", and on the following 
  29.      line put a command to re-boot the system.  Programs to do 
  30.      that are available in the public domain, and are usually 
  31.      called something like "BOOT.COM", "REBOOT.COM" etc.  You can 
  32.      create your own "BOOT.COM" by creating a file with the 5-
  33.      byte sequence "EA 00 00 FF FF", using DEBUG.
  34.  
  35. The effect of the above setup is the same for both machines: 
  36. during the startup procedure the NET program is started, and it 
  37. normally stays running (i.e. the startup procedure never 
  38. terminates).  Should the NET program ever exit, the next line in 
  39. the procedure (or the next program in the AUTO folder) will 
  40. reboot the machine, and the NET program will be re-started.
  41.  
  42.  
  43. Watchdog
  44.  
  45. In the event of a program crash, it is very inconvenient to have 
  46. to reset the machine manually.  Program crashes occur infre-
  47. quently, and only when no operator is watching.
  48. The program has a feature that allows the connection of a 
  49. hardware watchdog circuit, that will RESET the machine when the 
  50. program seems to hang.
  51.  
  52. The principle of such a circuit, is to generate a RESET pulse 
  53. when no activity has been sensed on the input of the circuit 
  54. during a certain interval of time.  The program can generate a 
  55. pulse on some output pin (e.g. a DATA line of the parallel 
  56. printer port) at each pass through the main loop.
  57.  
  58. It is also possible to connect the PTT output of a channel to 
  59. such a circuit, because the channel will always transmit the 
  60. nodelist at fixed intervals, so the node has crashed when the 
  61. transmitter is not activated for a long time.
  62.  
  63. For the Atari version of the program, the watchdog command also 
  64. allows the definition of a software timeout that will cause a 
  65. RESET of the machine after a certain period of inactivity, 
  66. without requiring external hardware.  This method provides some 
  67. protection against crashes, but is less reliable than the 
  68. hardware-assisted approach.
  69.  
  70. The command to activate the watchdog pulses is:
  71.  
  72. -    Atari ST systems:
  73.  
  74.      watchdog 180 600 01
  75.  
  76.      This enables 2 forms of watchdog:
  77.      1.   A software timer that will reset the machine when no 
  78.           activity has occurred for 180 seconds (or for 600 
  79.           seconds when a "shell" command has been given).
  80.      2.   An pulse output will be given on the lowest bit (D0) of 
  81.           the parallel printer output at each pass through the 
  82.           program loop.  Other outputs can be selected by speci-
  83.           fying a different 3rd parameter.  A value of 00 for the 
  84.           3rd parameter will disable the pulses on the parallel 
  85.           output.
  86.  
  87. -    MS-DOS systems:
  88.  
  89.      watchdog xxx xx
  90.  
  91.  
  92. Example configuration files
  93.  
  94. Below, the configuration files in use at PI8NOS (as of June 1990) 
  95. are listed.  These are real-life configuration files, that have 
  96. been in use and have been maintained for nearly a year.
  97.  
  98. The hardware in use at PI8NOS is an Atari Mega-ST2, with an 8-
  99. channel SCC interface and a 300baud modem connected to the AUX 
  100. (RS232) port.
  101.  
  102. ----------------------------------------------------------------
  103. AUTOEXEC.NET
  104. ----------------------------------------------------------------
  105.  
  106. # NET configuration file for PI8NOS network station in Hilversum
  107. # uses special SCC interface board with 4 Z8530s installed
  108. # AUX (rs232) is used as a connection to an async modem for remote control
  109. # MIDI is not used
  110. # Drive A: is a 720K floppy, drive G: is a 1MB RAMDisk
  111. #
  112. setenv NETDISK a:
  113. setenv RAMDISK g:
  114. #
  115. # define buffers for use by SCC driver
  116. memstat 100000
  117. buffers 64 2 128
  118. #
  119. # attach commands for SCC driver.  first init, then attach the channels.
  120. attach scc 4 init fffd00 8 3 7 -2 fffd3f 3 p4915200
  121. #                                               4 thru 7 are spare channels
  122. #attach scc 7 ax25 ax3  256 d4800 pi8nos-8
  123. #attach scc 6 ax25 ax2  256 d4800 pi8nos-7
  124. #attach scc 5 ax25 ax1  256 d4800 pi8nos-6
  125. #attach scc 4 ax25 ax0  256 d4800 pi8nos-5
  126. #                                               3 is west-link on 430.800
  127. attach scc 3 ax25 ln.w 256 d1200 pi8nos-4
  128. #                                               2 is south-link on 1299.900
  129. attach scc 2 ax25 ln.s 256 d1200 pi8nos-3
  130. #                                               1 is east-link on 1240.400/1299.400
  131. attach scc 1 ax25 ln.e 256 d1200 pi8nos-2
  132. #                                               0 is north-link on 1240.800
  133. attach scc 0 ax25 ln.n 256 d1200 pi8nos-1
  134. #
  135. # attach the NET/ROM interface & set the call to be used by NET/ROM level 3
  136. #
  137. attach netrom pi8nos
  138. #
  139. # filtering of unwanted AX.25 stations
  140. #
  141. ax25 exclude nocall
  142. ax25 exclude pi8nos
  143. #
  144. # setup some directories and files. RAMDisk is faster so transfer commonly
  145. # used files like HOSTS.NET to it. FTP public area is also on RAMDisk, and
  146. # is initialized with some of our configuration files.
  147. #
  148. cd ${NETDISK}\net
  149. mkdir -f ${RAMDISK}\tmp ${RAMDISK}\net ${RAMDISK}\net\mqueue ${RAMDISK}\public
  150. #
  151. copy $NETHOSTS ${RAMDISK}\net\hosts.net
  152. setenv NETHOSTS ${RAMDISK}\net\hosts.net
  153. #
  154. setenv TMPDIR ${RAMDISK}\tmp
  155. setenv TMP $TMPDIR
  156. del -f $TMPDIR\*.*
  157. #
  158. copy ${NETMAILQ}*.* ${RAMDISK}\net\mqueue
  159. del -f ${NETMAILQ}*.txt ${NETMAILQ}*.wrk ${NETMAILQ}*.lck
  160. setenv NETMAILQ ${RAMDISK}\net\mqueue\
  161. del -f ${NETMAILQ}*.lck
  162. #
  163. copy ${NETDISK}\net\nr_info.txt ${RAMDISK}\net
  164. copy alias $NETHOSTS routes.net finger\*.txt ${RAMDISK}\public
  165. setenv ENVSTYLE
  166. setenv TIMEZONE MET:0
  167. shell =${NETDISK}\arc.ttp
  168. #
  169. # remainder of configuration
  170. #
  171. source config.net
  172. #
  173. # Addresses, IP routing table and ARP commands, Misc
  174. #
  175. hostname pi8nos.ampr.org
  176. ip address pi8nos
  177. source routes.net
  178. log ${NETDISK}\net\net.log startup
  179. log proc
  180. watchdog 120 600 1
  181. #
  182. # NET/ROM configuration. Filtering and routes are in NETROM.NET
  183. #
  184. netrom info ${RAMDISK}\net\nr_info.txt
  185. netrom interface ln.n "HVS" 224
  186. netrom interface ln.s "HVS" 224
  187. netrom interface ln.e "HVS" 220
  188. netrom interface ln.w "HVS" 192 lap
  189. netrom tcpip link "#TCPIP"
  190. source netrom.net
  191. netrom route save ${RAMDISK}\net\netrom.rts
  192. source ${RAMDISK}\net\netrom.rts
  193. #
  194. # KISS and AX25 stuff for each TNC connected
  195. #
  196. mheard ln.n 23
  197. mheard ln.s 23
  198. mheard ln.e 23
  199. mheard ln.w 23
  200. ax25 digipeat ln.n gate
  201. ax25 digipeat ln.s gate
  202. ax25 digipeat ln.e gate
  203. ax25 digipeat ln.w gate
  204. #ax25 persist ln.n 128 5 128 60 900
  205. #ax25 persist ln.s 128 5 128 60 900
  206. #ax25 persist ln.e 128 5 128 60 900
  207. ax25 persist ln.w 128 24 64 60 900
  208. #
  209. # AX25 ports.  1=TNC 2=NetDigi 3=MHEARD 4=Bridge
  210. #
  211. ax25 port 2 digi pi8nos-9  ln.n gate
  212. ax25 port 2 digi pi8nos-10 ln.e gate
  213. ax25 port 2 digi pi8nos-11 ln.s gate
  214. ax25 port 2 digi pi8nos-12 ln.w gate
  215. ax25 port 3 conn pi8nos-9  ln.n multi
  216. ax25 port 3 conn pi8nos-10 ln.e multi
  217. ax25 port 3 conn pi8nos-11 ln.s multi
  218. ax25 port 3 conn pi8nos-12 ln.w multi
  219. ax25 port 4 conn pi8nos-15
  220. ax25 port 6 conn pi8nos-14
  221. #
  222. # SCC driver interface groups
  223. #
  224. param ln.n group 001
  225. param ln.s group 106
  226. param ln.e group 103
  227. param ln.w group 000
  228. #
  229. # initialize SCC driver on ln.n
  230. #
  231. param ln.n 2 128
  232. param ln.n 7 1
  233. param ln.n 8 15
  234. #
  235. # initiali